<!DOCTYPE html>
<!-- saved from url=(0044)https://www.greendizer.com/docs/api/sellers/ -->
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:og="http://ogp.me/ns#" xmlns:fb="http://www.facebook.com/2008/fbml" lang="en" class=" js borderradius boxshadow textshadow opacity"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><script src="./REST API for sellers - Greendizer_files/cb=gapi.loaded0" async=""></script><script type="text/javascript" async="" src="./REST API for sellers - Greendizer_files/plusone.js" gapi_processed="true"></script><script type="text/javascript" async="" src="./REST API for sellers - Greendizer_files/ga.js"></script><script type="text/javascript" async="" src="./REST API for sellers - Greendizer_files/ga.js"></script><script type="text/javascript">
//<![CDATA[
try{if (!window.CloudFlare) { var CloudFlare=[{verbose:0,p:0,byc:0,owlid:0,mirage:0,oracle:"82/3f73793a7b7aa6a429141ec16904d2",paths:{cloudflare:"/cdn-cgi/nexp/v=1443929931/"},atok:"4e06fa8b804fb039e1f08e68ed044898",zone:"greendizer.com",rocket:"0",apps:{"ga_key":{"ua":"UA-23409453-4","ga_bs":"2"}}}];document.write('<script type="text/javascript" src="//ajax.cloudflare.com/cdn-cgi/nexp/v=3368044129/cloudflare.min.js"><'+'\/script>')}}catch(a){};
//]]>
</script><script type="text/javascript" src="./REST API for sellers - Greendizer_files/cloudflare.min.js"></script>
<script type="text/javascript">
//<![CDATA[
window.__CF=window.__CF||{};window.__CF.AJS={"ga_key":{"ua":"UA-23409453-4","ga_bs":"2"}};
//]]>
</script>
<title>REST API for sellers - Greendizer</title>
<script type="text/javascript">
(function(){
    try{ 
        var contentLanguage = document.getElementsByTagName("html")[0].lang;
        var cookieLocale;
        
        var urlMatch = window.location.href.match(new RegExp("\/([a-z]{2})\/", "i"));
        var urlLocale = urlMatch ? urlMatch[1] : "en";
        var browserLanguage = (window.navigator.language || 
                               window.navigator.browserLanguage).split("-")[0];
        
        //Building a hash of the available alternates to the current page.
        var alternates = {};
        var links = document.getElementsByTagName("link");
        for(var j=0; j < links.length; j++){
            alternates[links[j].hreflang] = links[j].href;
        }
        
        //Looking for the "locale" cookie.
        var cookies = document.cookie.split("; ");
        for(var i=0; i < cookies.length; i++){
            var parts = cookies[i].split("=");
            if(parts[0] === "locale"){
                cookieLocale = parts[1];
                
                if(parts[1] === contentLanguage){
                    /**
                     * Ideal case: the page's language matched the preferred
                     * language of the user according to the value carried
                     * by the "locale" cookie. 
                     */
                    return;
                } else if (parts[1] in alternates) {
                    /**
                     * Preferred language doesn't match the page's content language,
                     * but an alternate is available. 
                     */
                    window.location.href = alternates[parts[1]];
                }
                break;
            }
        }       
        
        /*
         * Case of a page loaded with from the cache,
         * and no cookie could be written by the server.
         */
        if(!cookieLocale && 
            contentLanguage === urlMatch &&
            browserLanguage !== contentLanguage){
            document.cookie = ["locale=" + contentLanguage,
                               "Path=/",
                               "Domain=.greendizer.com",
                               "Expires=" + new Date(new Date().getTime() + 999999999000).toUTCString(),
                               window.location.href.substr(0, 5) === "https" ? "secure" : ""].join('; ');
        }
        
        //Case of a first time visit, with no "locale" cookie available.
        if(!cookieLocale){
            /**
             * the content language is different from the default language
             * reported by the browser. Redirect the user if an alternate
             * in the user's preferred language is available.
             */
            if( (!urlMatch || urlLocale !== contentLanguage) &&
                browserLanguage !== contentLanguage &&
                browserLanguage in alternates){
                window.location.href = alternates[browserLanguage];
            }
        }
    } catch(e){;}
})();
</script>
<meta http-equiv="Content-Language" content="en">
<meta charset="text/html; charset=utf-8">
<meta name="viewport" content="width=1024">
<meta name="description" content="Learn how to interact with the Greendizer RESTful API as a seller.">
<meta name="keywords" content="invoice,bill,biller,seller,buyer,invoicer,exchange,estimate,quote,message,payment,developer,designer,company,business,invoicing,online,archive,realtime,application,apps,marketplace,viewer,creator,api,rest,leweb,cloud,computing,library,libraries,python,py,java,c#,csharp,php,js,javascript,digital,signature,rsa,encrypted,xmldsig,xml">
<meta name="robots" content="index,follow,noimageindex">
<meta name="slurp" content="nodir">
<meta name="author" content="Greendizer">
<meta name="copyright" content="2012 Greendizer SA">
<meta property="og:type" content="product">
<meta property="og:url" content="https://www.greendizer.com/">
<meta property="og:description" content="APIs and tools to add cloud-based invoicing capabilities to your systems, and build apps with realtime data from the invoices exchanges.">
<meta property="og:site_name" content="Greendizer">
<meta property="og:title" content="Greendizer">
<meta property="og:image" content="https://www.greendizer.com/static/images/logo.jpg">
<meta property="og:street-address" content="15 rue de Chambery">
<meta property="og:postal-code" content="75015">
<meta property="og:locality" content="Paris">
<meta property="og:country-name" content="France">
<meta property="fb:admins" content="563670170,612569218,568453298,561205053">
<meta property="fb:app_id" content="73222341311">
<link rel="publisher" href="https://plus.google.com/118361734809275351334">
<link rel="index" hreflang="en" href="https://www.greendizer.com/sitemap/">
<link type="text/css" href="./REST API for sellers - Greendizer_files/www.css" rel="stylesheet">
<link type="text/css" href="./REST API for sellers - Greendizer_files/www.columns.css" rel="stylesheet">
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/jquery.js"></script>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/jquery-ui.min.js"></script>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/saved_resource"></script>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/greendizer.common.min.js"></script>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/greendizer.website.min.js"></script>
<link type="text/css" href="./REST API for sellers - Greendizer_files/www.docs.css" rel="stylesheet">
<script type="text/javascript">
/* <![CDATA[ */
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-23409453-4']);
_gaq.push(['_trackPageview']);

(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();

(function(b){(function(a){"__CF"in b&&"DJS"in b.__CF?b.__CF.DJS.push(a):"addEventListener"in b?b.addEventListener("load",a,!1):b.attachEvent("onload",a)})(function(){"FB"in b&&"Event"in FB&&"subscribe"in FB.Event&&(FB.Event.subscribe("edge.create",function(a){_gaq.push(["_trackSocial","facebook","like",a])}),FB.Event.subscribe("edge.remove",function(a){_gaq.push(["_trackSocial","facebook","unlike",a])}),FB.Event.subscribe("message.send",function(a){_gaq.push(["_trackSocial","facebook","send",a])}));"twttr"in b&&"events"in twttr&&"bind"in twttr.events&&twttr.events.bind("tweet",function(a){if(a){var b;if(a.target&&a.target.nodeName=="IFRAME")a:{if(a=a.target.src){a=a.split("#")[0].match(/[^?=&]+=([^&]*)?/g);b=0;for(var c;c=a[b];++b)if(c.indexOf("url")===0){b=unescape(c.split("=")[1]);break a}}b=void 0}_gaq.push(["_trackSocial","twitter","tweet",b])}})})})(window);
/* ]]> */
</script>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/saved_resource(1)"></script><style type="text/css">.gssb_c{border:0;position:absolute;z-index:989}.gssb_e{border:1px solid #ccc;border-top-color:#d9d9d9;box-shadow:0 2px 4px rgba(0,0,0,0.2);-webkit-box-shadow:0 2px 4px rgba(0,0,0,0.2);cursor:default}.gssb_f{visibility:hidden;white-space:nowrap}.gssb_k{border:0;display:block;position:absolute;top:0;z-index:988}.gsib_a{width:100%;padding:4px 6px 0}.gsib_a,.gsib_b{vertical-align:top}.gssb_a{padding:0 7px}.gssb_a,.gssb_a td{white-space:nowrap;overflow:hidden;line-height:22px}#gssb_b{font-size:11px;color:#36c;text-decoration:none}#gssb_b:hover{font-size:11px;color:#36c;text-decoration:underline}.gssb_m{color:#000;background:#fff}.gssb_g{text-align:center;padding:8px 0 7px;position:relative}.gssb_h{font-size:15px;height:28px;margin:0.2em;-webkit-appearance:button}.gssb_i{background:#eee}.gss_ifl{visibility:hidden;padding-left:5px}.gssb_i .gss_ifl{visibility:visible}a.gssb_j{font-size:13px;color:#36c;text-decoration:none;line-height:100%}a.gssb_j:hover{text-decoration:underline}.gssb_l{height:1px;background-color:#e5e5e5}.gsq_a{padding:0}.gscsep_a{display:none}.gsfe_a{border:1px solid #b9b9b9;border-top-color:#a0a0a0;box-shadow:inset 0px 1px 2px rgba(0,0,0,0.1);-moz-box-shadow:inset 0px 1px 2px rgba(0,0,0,0.1);-webkit-box-shadow:inset 0px 1px 2px rgba(0,0,0,0.1);}.gsfe_b{border:1px solid #4d90fe;outline:none;box-shadow:inset 0px 1px 2px rgba(0,0,0,0.3);-moz-box-shadow:inset 0px 1px 2px rgba(0,0,0,0.3);-webkit-box-shadow:inset 0px 1px 2px rgba(0,0,0,0.3);}.gscb_a{display:inline-block;font:27px/13px arial,sans-serif}.gsst_a .gscb_a{color:#a1b9ed;cursor:pointer}.gsst_a:hover .gscb_a{color:#36c}.gsst_a,.gsst_d{display:inline-block}.gsst_a{cursor:pointer;padding:0 3px}.gsst_a:hover{text-decoration:none!important}.gsst_b{font-size:16px;padding:0 3px;user-select:none;-webkit-user-select:none;white-space:nowrap}.gsst_d{width:4px}.gsst_e{opacity:0.55;}.gsst_a:hover .gsst_e{opacity:0.72;}.gsst_a:active .gsst_e{opacity:1;}.gssb_a{padding:0 7px}.gssb_e{border:0}.gssb_l{margin:5px 0}.gssb_c .gsc-completion-container{position:static}.gssb_c{z-index:5000}.gsc-completion-container table{background:transparent;font-size:inherit;font-family:inherit}.gssb_c > tbody > tr,.gssb_c > tbody > tr > td,.gssb_d,.gssb_d > tbody > tr,.gssb_d > tbody > tr > td,.gssb_e,.gssb_e > tbody > tr,.gssb_e > tbody > tr > td{padding:0;margin:0;border:0}.gssb_a table,.gssb_a table tr,.gssb_a table tr td{padding:0;margin:0;border:0}</style><script type="text/javascript" src="./REST API for sellers - Greendizer_files/search.I.js"></script></head>
<body><div id="StayFocusd-infobar" style="display: none; top: 0px; "><img src="chrome-extension://laankejkbhbdhmipfmgcngdelahlfoji/img/eye_19x19_red.png"><span id="StayFocusd-infobar-msg"></span><span id="StayFocusd-infobar-links"><a href="https://www.greendizer.com/docs/api/sellers/#" id="StayFocusd-infobar-never-show">hide forever</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="https://www.greendizer.com/docs/api/sellers/#" id="StayFocusd-infobar-hide">hide once</a></span></div>
<div id="wrapper">
<div style="display:none;" class="language-warning"><img alt="" src="./REST API for sellers - Greendizer_files/en_flag.png"><span></span></div>
<script type="text/javascript" src="./REST API for sellers - Greendizer_files/widgets.min.js"></script>
<iframe style="display: none; position: fixed; width: 100%; height: 100%; z-index: 9999; top: 0px; left: 0px; background-color: transparent; " id="launchpad" frameborder="0" name="lang=en&amp;origin=https%3A//www.greendizer.com&amp;id=13360947382130.0723293183837086" data-gd-id="13360947382130.0723293183837086" src="./REST API for sellers - Greendizer_files/saved_resource(4).htm"></iframe>
<script type="text/javascript">
(function(){
    window.greendizer = window.greendizer || {};
    window.greendizer.showCentral = function(){
        var widget = greendizer.widgets.widgetManager.getInstance().getWidget($("#launchpad").get(0));
        widget && greendizer.website.Context.getInstance().isAuthenticated() && widget.show();
    };
})();
</script>
<header>
<span id="login-warning" style="display:none;" onclick="$(this).hide();" class="global-warning rounded-bottom">Login is not available at this time - Please try again in a moment.</span>
<a href="https://www.greendizer.com/"><img id="logo" alt="Greendizer" src="./REST API for sellers - Greendizer_files/logo.png"></a>
<div style="display: none; " id="user-surface">
<div id="user-surface-avatar">
<img id="user-surface-user-avatar" onerror="this.src=&#39;/static/images/userdefault.png&#39;" class="user">
<img id="user-surface-company-logo" style="display:none" class="company" width="32" height="32" onerror="this.src=&#39;/static/images/companydefault.128.png&#39;">
<div class="section">
<img onclick="window.greendizer.showCentral()" title="Central" id="user-surface-central" class="central" src="./REST API for sellers - Greendizer_files/gd32.png" alt="Central">
</div>
</div>
<div id="user-surface-name" class=" dark"></div>
</div>
<div id="header-buttons">
<a href="https://services.greendizer.com/signup/?locale=en" class="logged-out-only button" id="signup-button">Sign up</a>
<button onclick="greendizer.website.Context.getInstance().login(true)" style="" id="login">Login</button>
</div>
<img style="display: none; " id="login-loader" src="./REST API for sellers - Greendizer_files/loader.gif">
<nav id="nav-menu">
<a class=" dark" href="https://www.greendizer.com/features/">Features</a>
<a class=" light" href="https://www.greendizer.com/pricing/">Pricing</a>
<a class="focus dark" href="https://www.greendizer.com/docs/">Docs</a>
<a class=" light" href="https://www.greendizer.com/blog/">Blog</a>
</nav>
</header>
<section id="content">
<style type="text/css">#wrapper.pin-pushed #sub-menu #cse{display:none;}</style>
<section id="sub-menu">
<ul>
<li class="focus">
<h1>APIs</h1>
<ul>
<li><a hreflang="en" href="https://www.greendizer.com/docs/api/">Basics</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/api/oauth/">OAuth</a></li>
<li class="focus"><a hreflang="en" href="./REST API for sellers - Greendizer_files/REST API for sellers - Greendizer.htm">Sellers</a><div id="___plusone_0" style="height: 15px; width: 70px; display: inline-block; text-indent: 0px; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; background-image: initial; background-attachment: initial; background-origin: initial; background-clip: initial; background-color: transparent; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; float: none; line-height: normal; font-size: 1px; vertical-align: baseline; background-position: initial initial; background-repeat: initial initial; "><iframe allowtransparency="true" frameborder="0" hspace="0" marginheight="0" marginwidth="0" scrolling="no" style="width: 70px; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; height: 15px; position: static; left: 0px; top: 0px; visibility: visible; " tabindex="0" vspace="0" width="100%" id="I1_1336094738562" name="I1_1336094738562" src="./REST API for sellers - Greendizer_files/fastbutton(1).htm" title="+1"></iframe></div></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/api/buyers/">Buyers</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/api/xmli/">XMLi</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/api/public/">Public resources</a></li>
</ul>
</li>
<li>
<h1>Libraries</h1>
<ul>
<li><a hreflang="en" href="https://www.greendizer.com/docs/libraries/">Basics</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/libraries/sellers/">Sellers</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/libraries/buyers/">Buyers</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/libraries/xmli/">XMLi</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/libraries/downloads/">Downloads</a></li>
</ul>
</li>
<li>
<h1>Widgets</h1>
<ul>
<li><a hreflang="en" href="https://www.greendizer.com/docs/widgets/">Explore</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/widgets/invoicelist/">Invoice List</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/widgets/invoiceviewer/">Invoice Viewer</a></li>
<li><a hreflang="en" href="https://www.greendizer.com/docs/widgets/invoicecreator/">Invoice Creator</a></li>
</ul>
</li>
<li>
<h1>Support</h1>
<ul>
<li><a href="http://code.google.com/p/greendizer-api/">Report issues</a></li>
</ul>
</li>
</ul>
<div style="padding-bottom:20px;" class="clear"></div>
<div>
<div id="cse" style="width: 80%;"><div class="gsc-control-cse gsc-control-cse-en"><div class="gsc-control-wrapper-cse" dir="ltr"><form class="gsc-search-box" accept-charset="utf-8"><table cellspacing="0" cellpadding="0" class="gsc-search-box"><tbody><tr><td class="gsc-input"><input autocomplete="off" type="text" size="10" class=" gsc-input " name="search" title="search" id="gsc-i-id1" dir="ltr" spellcheck="false" style="outline-style: none; outline-width: initial; outline-color: initial; background-image: url(https://www.google.com/cse/intl/en/images/google_custom_search_watermark.gif); background-attachment: initial; background-origin: initial; background-clip: initial; background-color: rgb(255, 255, 255); background-position: 0% 50%; background-repeat: no-repeat no-repeat; "></td><td class="gsc-search-button"><input type="button" value="Search" class="gsc-search-button" title="search"></td><td class="gsc-clear-button"><div class="gsc-clear-button" title="clear results">&nbsp;</div></td></tr></tbody></table><table cellspacing="0" cellpadding="0" class="gsc-branding"><tbody><tr><td class="gsc-branding-user-defined"></td><td class="gsc-branding-text"><div class="gsc-branding-text">powered by</div></td><td class="gsc-branding-img"><img src="./REST API for sellers - Greendizer_files/small-logo.png" class="gsc-branding-img"></td></tr></tbody></table></form><div class="gsc-tabsAreaInvisible"><div class="gsc-tabHeader gsc-inline-block gsc-tabhActive">Custom Search</div><span class="gs-spacer"> </span></div><div class="gsc-tabsAreaInvisible"></div><div class="gsc-above-wrapper-area-invisible"><table cellspacing="0" cellpadding="0" class="gsc-above-wrapper-area-container"><tbody><tr><td class="gsc-result-info-container"><div class="gsc-result-info-invisible"></div></td></tr></tbody></table></div><div class="gsc-adBlockInvisible"></div><div class="gsc-wrapper"><div class="gsc-adBlockInvisible"></div><div class="gsc-resultsbox-invisible"><div class="gsc-resultsRoot gsc-tabData gsc-tabdActive"><table cellspacing="0" cellpadding="0" class="gsc-resultsHeader"><tbody><tr><td class="gsc-twiddleRegionCell"><div class="gsc-twiddle"><div class="gsc-title">Web</div></div><div class="gsc-stats"></div><div class="gsc-results-selector gsc-all-results-active"><div class="gsc-result-selector gsc-one-result" title="show one result">&nbsp;</div><div class="gsc-result-selector gsc-more-results" title="show more results">&nbsp;</div><div class="gsc-result-selector gsc-all-results" title="show all results">&nbsp;</div></div></td><td class="gsc-configLabelCell"></td></tr></tbody></table><div><div class="gsc-expansionArea"></div></div></div></div></div></div></div></div>
<script src="./REST API for sellers - Greendizer_files/jsapi" type="text/javascript"></script>
<script async="true" type="text/javascript"> 
          google.load('search', '1', {language : 'en'});
          google.setOnLoadCallback(function() {
            var customSearchOptions = {};  var customSearchControl = new google.search.CustomSearchControl(
              '003680668979917808190:068bct4psie', customSearchOptions);
            customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET);
            customSearchControl.draw('cse');
          }, true);
        </script><script src="./REST API for sellers - Greendizer_files/saved_resource(2)" type="text/javascript"></script><link href="./REST API for sellers - Greendizer_files/default+en.css" type="text/css" rel="stylesheet"><script src="./REST API for sellers - Greendizer_files/default+en.I.js" type="text/javascript"></script>
<link rel="stylesheet" href="./REST API for sellers - Greendizer_files/www.search.css" type="text/css">
</div>
</section>
<script type="text/javascript">
	$(document).bind("ready", function(){
		var request_url = '/docs/api/sellers/'.split("?")[0];
		var submenuDOM = $("#sub-menu");
		
		var cseDOM = $("#cse");
		submenuDOM.data("push-test", function(){
		    return cseDOM.find(".gsc-result-info-invisible").size() !== 0;
		});
		
		target = submenuDOM.find("[href='" + request_url + "']");
		target.parent().addClass("focus").parent().parent().addClass("focus");
		target.parent().html(target.parent().html() + '<g:plusone size="small"></g:plusone>');
	});
</script>
<section id="content-items">
<article class="content-item"><section class="content">
<h3>Content</h3>
<div>
<ul class="tableofcontent">
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections">Collections</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections_emails">Listing email addresses</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections_invoices">Listing, filtering and sending invoices</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections_invoicereports">Listing and filtering invoicing reports</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections_threads">Listing, filtering and opening conversation threads</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#collections_messages">Listing and sending messages</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#seller">Seller</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#seller_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#seller_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#settings">Settings</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#settings_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#settings_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#company">Company</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#company_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#company_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#email">Email</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#email_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#email_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#buyer">Buyer</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#buyer_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#buyer_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoice">Invoice</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoice_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoice_attributes">Attributes</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoice_filters">Filters</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoicereport">Invoice Delivery Report</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoicereport_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoicereport_attributes">Attributes</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#invoicereport_filters">Filters</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#thread">Thread</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#thread_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#thread_attributes">Attributes</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#thread_filters">Filters</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#message">Message</a>
<ul>
<li><a href="https://www.greendizer.com/docs/api/sellers/#message_overview">Overview</a></li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#message_attributes">Attributes</a></li>
</ul>
</li>
<li><a href="https://www.greendizer.com/docs/api/sellers/#notes">Notes</a></li>
</ul>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="collections">Collections</h3>
<div>
<h4 id="collections_emails">Listing email addresses</h4>
<pre><code>sellers/<strong>{seller id}</strong>/emails/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>HEAD</code>, <code>GET</code></td>
<td>Returns the list of emails attached to the buyer's account.</td>
</tr>
</tbody>
</table>
<h4 id="collections_invoices">Listing, filtering and sending invoices</h4>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>HEAD</code>, <code>GET</code></td>
<td>Returns the list of invoices sent by the user.</td>
</tr>
<tr>
<td><code>POST</code></td>
<td>Sends one or multiple invoices to buyers.</td>
</tr>
</tbody>
</table>
<br>
<p>You can filter Invoices based on the attributes in the <a href="https://www.greendizer.com/docs/api/sellers/#invoice_filters">invoice filters list</a>.</p>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/?q=<strong>filter</strong></code></pre>
<br>
<p>To send a new invoice, make a <code>POST</code> request to this collection with <a href="https://www.greendizer.com/docs/api/xmli/">a valid XMLi</a> in its body.</p>
<pre id="xmliexample"><code>POST sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices HTTP/1.1
Accept: <strong>application/json</strong>
Content-Type: application/xml

&lt;?xml version='1.0' encoding='UTF-8'?&gt;
&lt;xmli <strong>version="gd-xmli-1.1"</strong>&gt;
    &lt;invoices&gt;
        &lt;invoice&gt;
            &lt;buyer&gt;
                &lt;name&gt;<strong>Jimi Hendrix</strong>&lt;/name&gt;
                &lt;email&gt;<strong>jimi.hendrix@springshield.com</strong>&lt;/email&gt;
                &lt;address&gt;
                    &lt;streetAddress&gt;<strong>15 rue de Chambery</strong>&lt;/streetAddress&gt;
                    &lt;zipcode&gt;<strong>75015</strong>&lt;/zipcode&gt;
                    &lt;city&gt;<strong>Paris</strong>&lt;/city&gt;
                    &lt;country&gt;<strong>FR</strong>&lt;/country&gt;
                &lt;/address&gt;
            &lt;/buyer&gt;
            &lt;name&gt;<strong>Name of the invoice</strong>&lt;/name&gt;
            &lt;description&gt;<strong>Description of the content of the invoice</strong>&lt;/description&gt;
            &lt;date&gt;<strong>2011-02-01</strong>&lt;/date&gt;
            &lt;dueDate&gt;<strong>2011-02-25</strong>&lt;/dueDate&gt;
            &lt;currency&gt;<strong>USD</strong>&lt;/currency&gt;
            &lt;total&gt;<strong>100</strong>&lt;/total&gt;
            &lt;status&gt;<strong>due</strong>&lt;/status&gt;
            &lt;body <strong>xmlns:myCompany="http://domain.example.com"</strong>&gt;
                &lt;groups&gt;
                    &lt;group&gt;
                        &lt;name&gt;<strong>Main group</strong>&lt;/name&gt;
                        &lt;description&gt;<strong>Main Invoice Group</strong>&lt;/description&gt;
                        &lt;lines&gt;
                            &lt;line&gt;
                                &lt;name&gt;<strong>Product or service name</strong>&lt;/name&gt;
                                &lt;description&gt;<strong>Product description</strong>&lt;/description&gt;
                                &lt;quantity&gt;<strong>10</strong>&lt;/quantity&gt;
                                &lt;unitPrice&gt;<strong>1</strong>&lt;/unitPrice&gt;
                            &lt;/line&gt;
                        &lt;/lines&gt;
                        &lt;custom&gt;
                        	&lt;myCompany:points&gt;<strong>343</strong>&lt;/myCompany:points&gt;
                        &lt;/custom&gt;
                    &lt;/group&gt;
                &lt;/groups&gt;
                &lt;custom&gt;
                	&lt;myCompany:client&gt;<strong>12545343</strong>&lt;/myCompany:client&gt;
                &lt;/custom&gt;
            &lt;/body&gt;
        &lt;/invoice&gt;
    &lt;/invoices&gt;
&lt;xmli&gt;</code></pre>
<br>
<p>Please refer to the XMLi reference for more information about how to build a valid XML invoice.</p>
<br>
<a class="button RoundedBottom RoundedTop" href="https://www.greendizer.com/docs/api/xmli/">» XMLi Reference</a>
<h4 id="collections_invoicereports">Listing and filtering invoicing reports</h4>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/reports/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>HEAD</code>, <code>GET</code></td>
<td>Returns the list of invoice delivery reports for the seller.</td>
</tr>
</tbody>
</table>
<br>
<p>You can also filter the invoicing reports using the attributes in the <a href="https://www.greendizer.com/docs/api/sellers/#invoicereport_filters">invoicing report filters list</a>.</p>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/reports/?q=<strong>filter</strong></code></pre>
<h4 id="collections_threads">Listing, filtering and opening new conversation threads</h4>
<pre><code>sellers/<strong>{seller id}</strong>/threads/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>HEAD</code>, <code>GET</code></td>
<td>Returns the list of threads.</td>
</tr>
<tr>
<td><code>POST</code></td>
<td>Opens a new conversation thread with a user.</td>
</tr>
</tbody>
</table>
<br>
<p>You can also filter the threads collection using the attributes in the <a href="https://www.greendizer.com/docs/api/sellers/#thread_filters">thread filters list</a>.</p>
<pre><code>sellers/<strong>{seller id}</strong>/threads/?q=<strong>filter</strong></code></pre>
<br>
<p>To open a new conversation thread, make a <code>POST</code> request to this collection and include the following arguments in its body:</p>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>recipient</code></td>
<td>The ID of the user with whom this thread will be opened as a <code>string</code>.</td>
</tr>
<tr>
<td><code>subject</code></td>
<td>The subject of the thread as a <code>string</code>.</td>
</tr>
<tr>
<td><code>message</code></td>
<td>The content of your first message as a <code>string</code>.</td>
</tr>
</tbody>
</table>
<pre><code>POST sellers/<strong>0</strong>/threads HTTP/1.1
Accept: <strong>application/json</strong>
Content-Type: application/x-www-form-urlencoded

recipient=<strong>1284</strong>&amp;subject=<strong>The wind</strong>&amp;message=<strong>It cries Mary</strong></code></pre>
<h4 id="collections_messages">Listing and sending messages</h4>
<pre><code>sellers/<strong>{seller id}</strong>/threads/<strong>{thread id}</strong>/messages/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>HEAD</code>, <code>GET</code></td>
<td>Returns the list of messages contained in a thread.</td>
</tr>
<tr>
<td><code>POST</code></td>
<td>Creates a new message.</td>
</tr>
</tbody>
</table>
<br>
<p>To send a new message, make a <code>POST</code> request to this collection and include the following arguments in its body:</p>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>text</code></td>
<td>The content of your message as a <code>string</code>.</td>
</tr>
</tbody>
</table>
<pre><code>POST sellers/<strong>0</strong>/threads/<strong>124</strong>/messages HTTP/1.1
Accept: <strong>application/json</strong>
Content-Type: application/x-www-form-urlencoded

text=<strong>Hello, world!</strong></code></pre>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="seller">Seller</h3>
<div>
<h4 id="seller_overview">Overview</h4>
<p>Represents the profile of a seller.</p>
<pre><code>sellers/<strong>{seller id}</strong>/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
</tbody>
</table>
<h4 id="seller_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>firstname</code></td>
<td>The first name of the seller as a <code>string</code>.</td>
</tr>
<tr>
<td><code>lastname</code></td>
<td>The last name of the seller as a <code>string</code>.</td>
</tr>
<tr>
<td><code>birthday</code></td>
<td>A <code>timestamp</code> in milliseconds representing the seller's birthday.</td>
</tr>
<tr>
<td><code>avatar</code></td>
<td>The URI of the seller's avatar picture.</td>
</tr>
<tr>
<td><code>gender</code></td>
<td>The gender of the seller.</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="settings">Settings</h3>
<div>
<h4 id="settings_overview">Overview</h4>
<p>Represents the settings of the seller.</p>
<pre><code>sellers/<strong>{seller id}</strong>/settings/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
</tbody>
</table>
<h4 id="settings_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>language</code></td>
<td>The language of the user as a <a href="http://reference.sitepoint.com/html/lang-codes">two letter code </a> <code>string</code>.</td>
</tr>
<tr>
<td><code>region</code></td>
<td>The regional settings of the user as a <code>string</code>. The format is:<br><code>{two letter language code}-{two letter country code}</code>.</td>
</tr>
<tr>
<td><code>currency</code></td>
<td>A three digit representation of the currency set in the user's settings.<code></code></td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="company">Company</h3>
<div>
<h4 id="company_overview">Overview</h4>
<p>Represents the company for whom the seller works.</p>
<pre><code>sellers/<strong>{seller id}</strong>/company/</code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
</tbody>
</table>
<h4 id="company_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>name</code></td>
<td>The name of the company as a <code>string</code>.</td>
</tr>
<tr>
<td><code>description</code></td>
<td>A short description of the company as a <code>string</code>.</td>
</tr>
<tr>
<td><code>verified</code></td>
<td>A boolean indicating whether or not the company was verified.</td>
</tr>
<tr>
<td><code>smallLogo</code></td>
<td>The URI of the small version of the company's logo as a <code>string</code>.</td>
</tr>
<tr>
<td><code>largeLogo</code></td>
<td>The URI of the large version of the company's logo as a <code>string</code>.</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="email">Email</h3>
<div>
<h4 id="email_overview">Overview</h4>
<p>Represents an email address registered by a user or shared with him.</p>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong></code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
</tbody>
</table>
<h4 id="email_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>label</code></td>
<td>An friendly name given by the user to refer to the email address as a <code>string</code>.</td>
</tr>
<tr>
<td><code>address</code></td>
<td>The email address.</td>
</tr>
<tr>
<td><code>verified</code></td>
<td>A <code>boolean</code> value representing the status of the email.</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="buyer">Buyer</h3>
<div>
<h4 id="buyer_overview">Overview</h4>
<p>Represents the profile and the history of a customer (buyer) with whom the seller has exchanged invoices or messages.</p>
<pre><code>sellers/<strong>{seller id}</strong>/buyers/<strong>{buyer email id}</strong></code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
</tbody>
</table>
<h4 id="buyer_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>name</code></td>
<td>The name of the buyer.</td>
</tr>
<tr>
<td><code>address</code></td>
<td>An <code>object</code> representing the postal address of the buyer.</td>
</tr>
<tr>
<td><code>delivery</code></td>
<td>An <code>object</code> representing the delivery address of the buyer if available.</td>
</tr>
<tr>
<td><code>currencies</code></td>
<td>A <code>list</code> of <code>objects</code> containing statistics about the invoices on a currency basis.
<br>Available metrics are <code>min</code>, <code>max</code>, <code>average</code> and <code>total</code>.
</td>
</tr>
<tr>
<td><code>invoicesCount</code></td>
<td>An <code>integer</code> representing the total number of invoices exchanged with between the buyer and the current seller.</td>
</tr>
<tr>
<td><code>threadsCount</code></td>
<td>An <code>integer</code> representing the total number of conversation threads opened between the buyer and the current seller.</td>
</tr>
<tr>
<td><code>messagesCount</code></td>
<td>An <code>integer</code> representing the total number of messages exchanged with between the buyer and the current seller.</td>
</tr>
</tbody>
</table>
<pre><code class="">{
    "name":"<span class="accent">Jimi Hendrix</span>",
    "address":{
        "number":"<span class="accent">2</span>",
        "street":"<span class="accent">rue de Grenelle</span>",
        "zipcode":"<span class="accent">75007</span>",
        "city":"<span class="accent">Paris</span>",
        "country":"<span class="accent">FR</span>"
    },
    "delivery":{
        "number":"<span class="accent">14</span>",
        "street":"<span class="accent">avenue de la Grande Armée</span>",
        "zipcode":"<span class="accent">75008</span>",
        "city":"<span class="accent">Paris</span>",
        "country":"<span class="accent">FR</span>"
    },
    "currencies":["<span class="accent">USD</span>", "<span class="accent">EUR</span>", "<span class="accent">MAD</span>"],
    "<span class="accent">USD</span>":{
        "min":<span class="accent">1</span>,
        "max":<span class="accent">1299.22</span>,
        "average":<span class="accent">657.23</span>,
        "total":<span class="accent">12987.98</span>
    },
    "<span class="accent">EUR</span>":{
        "min":<span class="accent">76.07</span>,
        "max":<span class="accent">129.22</span>,
        "average":<span class="accent">73.23</span>,
        "total":<span class="accent">9877.98</span>
    },
    "<span class="accent">MAD</span>":{
        "min":<span class="accent">3422.12</span>,
        "max":<span class="accent">123423.66</span>,
        "average":<span class="accent">9283.76</span>,
        "total":<span class="accent">1928283.24</span>
    },
    "invoicesCount":<span class="accent">87</span>,
    "threadsCount":<span class="accent">22</span>,
    "messagesCount":<span class="accent">180</span>
}</code></pre>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="invoice">Invoice</h3>
<div>
<h4 id="invoice_overview">Overview</h4>
<p>Represents an invoice sent by the seller.</p>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/<strong>{invoice id}</strong></code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code>, <code>PATCH</code>, <code>DELETE</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
<tr>
<td>OAuth scopes</td>
<td><code>read_invoices</code>, <code>modify_invoices</code></td>
</tr>
</tbody>
</table>
<h4 id="invoice_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col class="rights">
<col>
</colgroup>
<tbody>
<tr>
<td><code>secretKey</code></td>
<td>Read-only</td>
<td>A random secret key generated for this invoice as a<code>string</code>.</td>
</tr>
<tr>
<td><code>name</code></td>
<td>Read-only</td>
<td>The title given by the seller to the invoice as a <code>string</code>.</td>
</tr>
<tr>
<td><code>description</code></td>
<td>Read-only</td>
<td>The description given by the seller to the invoice as a <code>string</code>.</td>
</tr>
<tr>
<td><code>buyer</code></td>
<td>Read-only</td>
<td>An <code>object</code> representing the buyer information included in the invoice.
<ul>
<li><code>name</code>: the buyer name</li>
<li><code>email</code>: the buyer email address</li>
<li><code>address</code>: the buyer postal address</li>
<li><code>delivery</code>: the buyer delivery address (if available)</li>
<li><code>uri</code>: the buyer resource URI</li>
</ul>
</td>
</tr>
<tr>
<td><code>date</code></td>
<td>Read-only</td>
<td>A <code>timestamp</code> representing the invoice date.</td>
</tr>
<tr>
<td><code>due_date</code></td>
<td>Read-only</td>
<td>A <code>timestamp</code> representing the date on which the invoice is due.</td>
</tr>
<tr>
<td><code>currency</code></td>
<td>Read-only</td>
<td>The currency of the invoice as a 3 letters code <code>string</code>.</td>
</tr>
<tr>
<td><code>total</code></td>
<td>Read-only</td>
<td>The total of the invoice as a <code>float</code>.</td>
</tr>
<tr>
<td><code>location</code></td>
<td></td>
<td>An <code>integer</code> representing the folder in which the invoice is located:
<ul>
<li><code>0</code> for <code>Inbox</code></li>
<li><code>1</code> for <code>Archives</code></li>
<li><code>2</code> for <code>Trash</code></li>
</ul>
</td>
</tr>
<tr>
<td><code>read</code></td>
<td></td>
<td>A <code>boolean</code> indicating whether or not the invoice has been read.</td>
</tr>
<tr>
<td><code>flagged</code></td>
<td></td>
<td>A <code>boolean</code> indicating whether or not the invoice has been flagged.</td>
</tr>
<tr>
<td><code>paid</code></td>
<td></td>
<td>A <code>boolean</code> indicating whether or not the invoice has been paid.</td>
</tr>
<tr>
<td><code>payable</code></td>
<td>Read-only</td>
<td>A <code>boolean</code> indicating whether or not the invoice can be paid through Greendizer.</td>
</tr>
<tr>
<td><code>canceled</code></td>
<td>Read-only</td>
<td>A <code>boolean</code> indication whether or not the invoice has been canceled.</td>
</tr>
<tr>
<td><code>body</code></td>
<td>Read-only</td>
<td>The XML representation of the invoice body as a <code>string</code>.</td>
</tr>
</tbody>
</table>
<h4 id="invoice_filters">Filters</h4>
<table class="">
<colgroup>
<col>
<col class="rights">
<col>
</colgroup>
<tbody>
<tr>
<td><code>flagged</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>read</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>paid</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>canceled</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>location</code></td>
<td>Integer</td>
<td></td>
</tr>
<tr>
<td><code>date</code></td>
<td>Timestamp</td>
<td></td>
</tr>
<tr>
<td><code>dueDate</code></td>
<td>Timestamp</td>
<td></td>
</tr>
<tr>
<td><code>modifiedDate</code></td>
<td>Timestamp</td>
<td></td>
</tr>
<tr>
<td><code>customId</code></td>
<td>String</td>
<td>The value of the customId field in the invoice.</td>
</tr>
<tr>
<td><code>currency</code></td>
<td>String</td>
<td></td>
</tr>
<tr>
<td><code>secret</code></td>
<td>String</td>
<td>The unique secret ID of the invoice</td>
</tr>
<tr>
<td><code>total</code></td>
<td>Float</td>
</tr>
<tr>
<td><code>buyer</code></td>
<td>String</td>
<td>The Buyer's email address</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="invoicereport">Invoicing Report</h3>
<div>
<h4 id="invoicereport_overview">Overview</h4>
<p>Represents a report with information about an invoice sending request.</p>
<pre><code>sellers/<strong>{seller id}</strong>/emails/<strong>{email id}</strong>/invoices/reports/<strong>{report id}</strong></code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
<tr>
<td>OAuth scopes</td>
<td><code>modify_invoices</code></td>
</tr>
</tbody>
</table>
<h4 id="invoicereport_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>startTime</code></td>
<td>Date and time at which the server started processing your request as a <code>timestamp</code>.</td>
</tr>
<tr>
<td><code>elapsedTime</code></td>
<td>Date and time at which the server finished processing your request as a <code>timestamp</code>.</td>
</tr>
<tr>
<td><code>state</code></td>
<td>An <code>integer</code> representing the folder in which the invoice is located:
<ul>
 
<li><code>0</code> for <code>Accepted</code></li>
<li><code>1</code> for <code>Running</code></li>
<li><code>2</code> for <code>Postponed</code></li>
<li><code>3</code> for <code>Canceled</code></li>
<li><code>4</code> for <code>Succeeded</code></li>
<li><code>5</code> for <code>Failed</code></li>
</ul>
</td>
</tr>
<tr>
<td><code>errorStack</code></td>
<td>A <code>string</code> containing an error message if one was encountered.</td>
</tr>
<tr>
<td><code>invoicesCount</code></td>
<td>A <code>integer</code> representing the number of invoices successfully processed.</td>
</tr>
<tr>
<td><code>hash</code></td>
<td>An SHA-1 hash of the invoices you have sent as a <code>string</code>.</td>
</tr>
<tr>
<td><code>ipAddress</code></td>
<td>The IP address of the machine that sent the invoice.</td>
</tr>
</tbody>
</table>
<h4 id="invoicereport_filters">Filters</h4>
<table class="">
<colgroup>
<col>
<col class="rights">
<col>
</colgroup>
<tbody>
<tr>
<td><code>state</code></td>
<td>Integer</td>
<td></td>
</tr>
<tr>
<td><code>hash</code></td>
<td>String</td>
<td></td>
</tr>
<tr>
<td><code>sender</code></td>
<td>String</td>
<td>The email address of the buyer the invoice was sent to</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="thread">Thread</h3>
<div>
<h4 id="thread_overview">Overview</h4>
<p>Represents a thread which contains one or more messages.</p>
<pre><code>sellers/<strong>{seller id}</strong>/threads/<strong>{thread id}</strong></code></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code>, <code>PATCH</code>, <code>DELETE</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
<tr>
<td>OAuth scopes</td>
<td><code>read_messages</code>, <code>modify_messages</code></td>
</tr>
</tbody>
</table>
<h4 id="thread_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col class="rights">
<col>
</colgroup>
<tbody>
<tr>
<td><code>subject</code></td>
<td>Read-only</td>
<td>A <code>string</code> representing the subject of the thread.</td>
</tr>
<tr>
<td><code>snippet</code></td>
<td>Read-only</td>
<td>A snippet of the last message sent or received as a <code>string</code>.</td>
</tr>
<tr>
<td><code>lastMessage</code></td>
<td>Read-only</td>
<td>A <code>timestamp</code> of the last message sent or received in the thread.</td>
</tr>
<tr>
<td><code>sellerURI</code></td>
<td>Read-only</td>
<td>A <code>string</code> representing the URI of the seller.</td>
</tr>
<tr>
<td><code>location</code></td>
<td></td>
<td>An <code>integer</code> representing the folder in which the thread is located:
<ul>
<li><code>0</code> for <code>Inbox</code></li>
<li><code>1</code> for <code>Archives</code></li>
<li><code>2</code> for <code>Trash</code></li>
</ul>
</td>
</tr>
<tr>
<td><code>count</code></td>
<td></td>
<td>An <code>integer</code> indicating the number of messages in the thread.</td>
</tr>
<tr>
<td><code>read</code></td>
<td></td>
<td>A <code>boolean</code> indicating whether the thread has been read or not.</td>
</tr>
<tr>
<td><code>flagged</code></td>
<td></td>
<td>A <code>boolean</code> indicating whether the thread has been flagged or not.</td>
</tr>
</tbody>
</table>
<h4 id="thread_filters">Filters</h4>
<table class="">
<colgroup>
<col>
<col class="rights">
<col>
</colgroup>
<tbody>
<tr>
<td><code>flagged</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>read</code></td>
<td>Boolean</td>
<td></td>
</tr>
<tr>
<td><code>location</code></td>
<td>Integer</td>
<td></td>
</tr>
<tr>
<td><code>date</code></td>
<td>Timestamp</td>
<td></td>
</tr>
<tr>
<td><code>modifiedDate</code></td>
<td>Timestamp</td>
<td>The date the thread was last modified.</td>
</tr>
<tr>
<td><code>lastMessageDate</code></td>
<td>Timestamp</td>
<td>The date of the last message in the thread</td>
</tr>
<tr>
<td><code>buyer</code></td>
<td>String</td>
<td>The Buyer's email address</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="message">Message</h3>
<div>
<h4 id="message_overview">Overview</h4>
<p>Represents a message which belongs to a thread.</p>
<pre><code>sellers/<strong>{seller id}</strong>/threads/<strong>{thread id}</strong>/messages/</code><strong>{message id}</strong></pre>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>Allowed methods</td>
<td><code>HEAD</code>, <code>GET</code></td>
</tr>
<tr>
<td>Protected</td>
<td><code>True</code></td>
</tr>
<tr>
<td>OAuth scopes</td>
<td><code>read_messages</code>, <code>modify_messages</code></td>
</tr>
</tbody>
</table>
<h4 id="message_attributes">Attributes</h4>
<table class="">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><code>text</code></td>
<td>The text of the message as a <code>string</code>.</td>
</tr>
<tr>
<td><code>createdDate</code></td>
<td>A <code>timestamp</code> representing the date at which the message was sent.</td>
</tr>
<tr>
<td><code>buyerURI</code> </td>
<td>[For Received Messages] The resource <code>URI</code> of the buyer sending the message.</td>
</tr>
</tbody>
</table>
</div>
</section></article>
<article class="content-item"><section class="content">
<h3 id="notes">Notes</h3>
<div>
<p>Version: 1.7.1</p>
<p>Last update: Feb 25<sup>th</sup>, 2012.</p>
<p>Contact: <a data-format="email" href="mailto:developers@greendizer.com">developers@greendizer.com</a></p>
</div>
</section></article>
</section>
</section>
<script type="text/javascript">
(function(){var instance = greendizer.website.Context.getInstance();(window.GREENDIZER_PROTECTED !== false) && instance.login();})();
("prettyPrint" in window) && prettyPrint();
</script>
<div id="push"></div>
</div>
<footer>
<div id="pre-footer">
<ol id="breadcrumbs" class="footer">
<li itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb" title="Home"><a itemprop="url" href="https://www.greendizer.com/"><img style="vertical-align: text-bottom; width:16px; height:16px;" alt="Home" src="./REST API for sellers - Greendizer_files/gd16bw.png"></a></li>
<li itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb"><a itemprop="url" href="https://www.greendizer.com/docs/"><span itemprop="title">Documentation and Resources</span></a></li>
<li itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb"><a itemprop="url" href="https://www.greendizer.com/docs/api/"><span itemprop="title">API</span></a></li>
<li itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb"><a itemprop="url" href="./REST API for sellers - Greendizer_files/REST API for sellers - Greendizer.htm"><span itemprop="title">Sellers</span></a></li>
</ol>
</div>
<nav>
<section>
<h1>Product</h1>
<ul>
<li><a title="Back to the home page" href="https://www.greendizer.com/">Home</a></li>
<li><a title="Explore the amazing features of Greendizer" href="https://www.greendizer.com/features/">Features</a></li>
<li><a title="More about our pricing" href="https://www.greendizer.com/pricing/">Pricing</a></li>
<li><a title="Visit our support site" href="http://support.greendizer.com/">Support</a></li>
</ul>
</section>
<section>
<h1>Docs</h1>
<ul>
<li><a title="Get started with our REST API, libs, widgets and tools to build apps." hreflang="en" href="https://www.greendizer.com/docs/">Get started</a></li>
<li><a title="REST API reference" hreflang="en" href="https://www.greendizer.com/docs/api/">API</a></li>
<li><a title="Invoicing and invoice-querying helper libs in languages like Python, Java, PHP and more" hreflang="en" href="https://www.greendizer.com/docs/libraries/">Libraries</a></li>
<li><a title="Powerful widgets to get the most out of Greendizer" hreflang="en" href="https://www.greendizer.com/docs/widgets/">Widgets</a></li>
</ul>
</section>
<section>
<h1>Company</h1>
<ul>
<li><a title="More about the company, the team and how to connect with both" href="https://www.greendizer.com/company/">About Greendizer</a></li>
<li><a title="Check out our blog for news, discussions and new features" href="https://www.greendizer.com/blog/">Blog</a></li>
<li>
<a target="_blank" title="Join us on Google+" href="https://plus.google.com/118361734809275351334">Google+</a>
<div id="___plusone_1" style="height: 15px; width: 70px; display: inline-block; text-indent: 0px; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; background-image: initial; background-attachment: initial; background-origin: initial; background-clip: initial; background-color: transparent; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; float: none; line-height: normal; font-size: 1px; vertical-align: baseline; background-position: initial initial; background-repeat: initial initial; "><iframe allowtransparency="true" frameborder="0" hspace="0" marginheight="0" marginwidth="0" scrolling="no" style="width: 70px; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; height: 15px; position: static; left: 0px; top: 0px; visibility: visible; " tabindex="0" vspace="0" width="100%" id="I2_1336094738579" name="I2_1336094738579" src="./REST API for sellers - Greendizer_files/fastbutton.htm" title="+1"></iframe></div>
</li>
<li>
<a target="_blank" title="Interact with Greendizer on Facebook" href="http://www.facebook.com/greendizer/">Facebook</a>
</li>
<li><a target="_blank" title="Follow Greendizer on Twitter" href="http://twitter.com/greendizer/">Twitter</a></li>
</ul>
</section>
<section>
<h1>Policies</h1>
<ul>
<li><a title="Terms of use of Greendizer" hreflang="en" href="https://www.greendizer.com/tos/">Terms of service</a></li>
</ul>
</section>
<section class="text">
<img width="92" height="92" alt="Greendizer" src="./REST API for sellers - Greendizer_files/gd_dark.png">
<p id="sitemap-link"><a title="Greendizer.com Site Map" href="https://www.greendizer.com/sitemap/">Site map</a></p>
<p>©2012 - All rights reserved.</p>
</section>
<div class="clear"></div>
</nav>
</footer>
<script type="text/javascript">
            (function() {
                window.___gcfg = {
                    lang: 'en',
                    parsetags: 'onload'
                };
                var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;
                po.src = 'https://apis.google.com/js/plusone.js';
                var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);
              })();
        </script>


<table cellspacing="0" cellpadding="0" style="display: none; top: 347px; width: 218px; left: 524px; position: absolute; " class="gstl_0 gssb_c"><tbody><tr><td class="gssb_f"></td><td class="gssb_e" style="width: 100%; "></td></tr></tbody></table></body></html>